home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / utility / fortn707.zip / FORTUNE.DOC < prev    next >
Text File  |  1997-07-31  |  29KB  |  598 lines
  1. FORTUNE.DOC                            1                           Jul 31, 1997
  2.  
  3. WIN95 AND WINNT NOTICE:  As with most DOS-based utilities, this program doesn't
  4. understand the weird subdirectories, long filenames,  invalid  characters  that
  5. are possible under Windows 95 and Windows/NT.   Both  operating  systems  alias
  6. long filenames into names like MYFILE~1.TXT and you will need  to  specify  the
  7. aliased versions of file names to process  them.   Under  some  file  structure
  8. systems in NT, the program may not work at all.
  9.  
  10. The FORTUNE.EXE program adds some tuning features to the DOS FOR  command  (FOR
  11. tune, fortune, what the heck).  These features can in some way  be  applied  to
  12. commands accepting regular DOS wildcards.  Features include:
  13.  
  14.   * Results of command are written to a batch file which you can review  before
  15.     you run it.  Lets you subsequently edit it if  desired  and  lets  you  see
  16.     exactly what commands will happen when you run it.
  17.   * Can execute the commands interactively if  they  don't  require  that  much
  18.     memory to run.
  19.   * Allows embedded redirection indicators in a command (see next example).
  20.   * Lets you separate the file name and file extension.  For example:
  21.          FORTUNE IN (*.TXT) DO SORT %[ %A %] %1*.SOR
  22.   * Lets you identify individual characters in the the file name and extension.
  23.     For example:
  24.          FORTUNE IN (*.TXT) DO RENAME %A (%1%2%3%4%5%6).*
  25.   * Lets you specify a character other than "%" for the delimiter  so  you  can
  26.     avoid worrying about different syntax in batch command vs command line.
  27.   * Can have the batch  file  pause  after  each  command  so  results  can  be
  28.     reviewed.
  29.   * Allows for incrementation in the file names.  For example:
  30.          FORTUNE IN (*.TXT) /+2 DO COPY %A %1*.%0001
  31.   * Allows multiple statements on one command line.
  32.   * Allows you to recurse through child subdirectories.  For example:
  33.          FORTUNE IN (\*.TXT) /S DO COPY %A D:\BACKUPS
  34.     Another example involves getting rid of an annoying hidden file  that  some
  35.     utility might keep dumping on your hard disk.  For example, I love the  ACD
  36.     Systems Ltd's ACD See program.  It lets you view lots of different  graphic
  37.     files under Windows.  Unfortunately, it typically  creates  a  hidden  file
  38.     called DESCRIPT.ION in each subdirectory that you visit with it.   This  is
  39.     annoying.  So to get rid of them all, you can issue the command:
  40.          FORTUNE IN \DESCRIPT.ION /S /ATTR=H DO ATTRIB %a -H $$ DEL %a
  41.     Another example.  Delete all batch files from the subdirectory forward:
  42.          FORTUNE *.BAT /S DEL %A
  43.   * Allows up to 10 file specifications from consideration.
  44.   * Allows you to limit files  processed  based  on  attributes,  filesize,  or
  45.     filedate.
  46.   * Lets can do those tough PKZIP commands that you always wanted to do.   Like
  47.     compress all *.FLI files in your subdirectory to a ZIP of the same name  as
  48.     the original file:
  49.          FORTUNE *.FLI DO PKZIP -M %R %e
  50.     Or move all WAV files into ZIP files with the same name  as  the  WAV  file
  51.     (separate ZIP for each WAV file):
  52.          FORTUNE *.WAV PKZIP -M %R %R.%E
  53.   * Allows you to use the command to create a file which contains a  series  of
  54.     commands including a header and footer section which can be used  for  some
  55.     batch functions.
  56.   * Pressing escape stops the program early.
  57.  
  58.  
  59. FORTUNE.DOC                            2                           Jul 31, 1997
  60.  
  61. The DOS FOR command:
  62.  
  63. Quite a few DOS users are unaware of the DOS FOR command.  It allows you to  do
  64. a single command over a series of  files  and  provides  an  easy  way  to  use
  65. wildcards with commands that don't accept them.  For example, if  you  want  to
  66. type a number of files to your screen, you can say something like:
  67.  
  68.         FOR %A IN (*.TXT) DO TYPE %A
  69.  
  70. DOS looks at your IN specification and figures out what file names are  covered
  71. by that request.  The request can include path information if desired  and  can
  72. have multiple specification (for example, "...IN (*.TXT \BAT\*.DOC)...").
  73.  
  74. FOR then substitutes the file name itself in for whatever variable you  specify
  75. in the first parameter after "FOR" ("%A" here).   This  variable  is  a  single
  76. character (A to Z) preceded by a single percent sign (%).  (If FOR is used in a
  77. batch command, you have to use two percent signs (%%) instead.)
  78.  
  79. FOR then looks at the command following the  keyword  "DO"  and  executes  that
  80. command.  If it finds the variable name in the command, it substitutes the name
  81. of the file for that variable.
  82.  
  83. So, in the above example, if you had three  *.TXT  files--ABLE.TXT,  BAKER.TXT,
  84. and CHARLIE.TXT--and you ran the command, it would actually do  three  commands
  85. for you:
  86.  
  87.         TYPE ABLE.TXT
  88.         TYPE BAKER.TXT
  89.         TYPE CHARLIE.TXT
  90.  
  91. All in all, FOR is a *very* useful command.  There are  also  some  DOS  tricks
  92. that you can use to make the command even more useful but,  frankly,  I  always
  93. forget the tricks.  (If someone would like to e-mail them  to  me,  I'll  throw
  94. them in here.) In any case, even past the tricks, the FORTUNE command  provides
  95. even more features.
  96.  
  97.  
  98.  
  99. FORTUNE.DOC                            3                           Jul 31, 1997
  100.  
  101. FORTUNE wildcards and special characters:
  102.  
  103. The FORTUNE.EXE program extends the functionality of the  DOS  FOR  command  by
  104. providing ways of splitting up the parts of the file name and manipulating  the
  105. parts.  For example, someone in my office had a mess of files that  had  to  be
  106. renamed as an open parenthesis, followed by the first  six  characters  of  the
  107. file name, followed by a close parenthesis.  Not too terrible to handle with my
  108. text editor but it hadn't occurred to her.  Using FORTUNE, however, it's pretty
  109. easy:
  110.  
  111.         FORTUNE IN (*.TXT) DO RENAME %A (%1%2%3%4%5%6).*
  112.  
  113. And then you run the newly-created batch file (DOIT.BAT).
  114.  
  115. Similarly, someone wanted me to rename a mess of files so they  had  sequential
  116. names.  I had  to  write  a  program  to  handle  it.   Definitely  beyond  his
  117. capabilities.  Again, using FORTUNE it's pretty easy:
  118.  
  119.         FORTUNE IN *.TXT DO RENAME %A %1*.%0001
  120.  
  121. And again you run the DOIT.BAT file.
  122.  
  123. Within the command (DO command), FORTUNE allows you  to  include  a  number  of
  124. indicators.  The character which indicates that it's  a  special  character  is
  125. typically "%" but you can change this with the /VAR=char option in FORTUNE. All
  126. of the examples here use the default /VAR=% setting.
  127.  
  128. NOTE TO 4DOS AND Win95 USERS:  4DOS  and  Windows  95  automatically  translate
  129. paired "%" characters even if used on the command line.  FORTUNE detects if you
  130. are running under 4DOS or Win95 and changes the default /VAR=%  to  /VAR=@  for
  131. you.  The following examples all presume /VAR=%; mentally shift them to be  "@"
  132. instead of "%" and you'll be fine.
  133.  
  134.  
  135. FORTUNE.DOC                            4                           Jul 31, 1997
  136.  
  137. In many cases, the indicators are case sensitive; there's a difference  between
  138. %p and %P (presuming the default /VAR=% delimiter).  Typically,  the  lowercase
  139. variants are cumulative.  %P gives you just the path whereas %p throws  in  the
  140. drive information too.
  141.  
  142.      %a or %A   translates into the entire file name (begins with drive,
  143.                 colon, \, path, \, file root, ., file extension).
  144.                 Use %R.%E if you want the filename without the drive/path info
  145.      %D         translates into the drive (not followed by :)
  146.      %d         translates into the drive (followed by :)
  147.      %P         translates into path (not preceded or followed by \)
  148.      %p         translates into path (begins with drive, colon, \, path, \)
  149.      %R         translates into file name root
  150.      %r         translates into file name root (begins with drive, colon, \,
  151.                 path, \)
  152.      %E         translates into file name extension
  153.      %e         translates into file name extension (begins with drive, colon,
  154.                 \, path, \, file name root, .)--same as %a
  155.      %1 to %8   characters 1 to 8 in the file name root
  156.      %X to %Z   characters 1 to 3 in file name extension (case insignificant;
  157.                 %X is the same as %x)
  158.      %*         replaces the character with the standard "*" wildcard
  159.      %?         replaces the character with the standard "?" wildcard
  160.  
  161. The standard DOS wildcards--"*" and "?"--are supported within  the  file  name.
  162. "...DO RENAME %A Q*.Y*" will actually generate commands with the letters filled
  163. in (if the file name is APPLES.ARE, the command will be RENAME QPPLES.YRE).
  164.  
  165. If you want to actually write out the commands and leave  in  the  "*"  or  "?"
  166. characters,  precede  the  wildcard  characters  with  "%"  (or  with  whatever
  167. delimiter you have specified in your /VAR=x parameter).  For example:
  168.  
  169.         FORTUNE (*.001) DO COPY %R.0%* %R.TOP
  170.  
  171. will generate something like "COPY TN960402.0* TN960402.TOP" whereas
  172.  
  173.         FORTUNE (*.001) DO COPY %R.0* %R.TOP
  174.  
  175. will generate "COPY TN960402.001 TN960402.TOP".
  176.  
  177. All other characters in the command string are passed as given.
  178.  
  179.  
  180. FORTUNE.DOC                            5                           Jul 31, 1997
  181.  
  182. Using  the  above  characters,  if  you  have  two  files  C:\AUTOEXEC.BAT  and
  183. D:\WAYNE\MYSTUFF.TXT, the various codes above translate as:
  184.  
  185.      filename:  C:\AUTOEXEC.BAT         D:\WAYNE\MYSTUFF.TXT
  186.  
  187.      %a or %A   C:\AUTOEXEC.BAT         D:\WAYNE\MYSTUFF.TXT
  188.      %D         C                       D
  189.      %d         C:                      D:
  190.      %P         (null)                  WAYNE
  191.      %p         \                       D:\WAYNE\
  192.      %R         AUTOEXEC                MYSTUFF
  193.      %r         C:\AUTOEXEC             D:\WAYNE\MYSTUFF
  194.      %E         BAT                     TXT
  195.      %e         C:\AUTOEXEC.BAT         D:\WAYNE\MYSTUFF.TXT
  196.      %1         A                       M
  197.      %2         U                       Y
  198.      %3         T                       S
  199.      %4         O                       T
  200.      %5         E                       U
  201.      %6         X                       F
  202.      %7         E                       F
  203.      %8         C                       (null)
  204.      %X         B                       T
  205.      %Y         A                       X
  206.      %Z         T                       T
  207.  
  208.  
  209.  
  210. Special translations:
  211.  
  212.      %[         translates into <
  213.      %]         translates into >
  214.      %0nnnn     incrementer field  (where  "nnnn"  is  any  number  of  digits;
  215.                 translates into a numeric field which has the  same  number  of
  216.                 digits excluding the zero after the delimiter; the first number
  217.                 will be the value  of  "nnnn"  and  subsequent  files  will  be
  218.                 incremented by the value specified in the /+n or /-n  parameter
  219.                 (defaults to /+1):  Examples:  %0001  will  start  with  "001";
  220.                 %00050 will start with "0050"
  221.  
  222.  
  223.  
  224. FORTUNE.DOC                            6                           Jul 31, 1997
  225.  
  226. Using a command file for special cases:
  227.  
  228. In addition, FORTUNE supports some options that might  be  used  outside  of  a
  229. batch file.  (There are also several uses for this within a batch command but I
  230. won't go into them here.  Think about it on your own.) For example,  let's  say
  231. you have an FTP program and you want to log onto the site and upload all of the
  232. *.TXT files in your subdirectory.  Normally, you'd do this by typing  something
  233. like this in response to the expected prompts:
  234.  
  235.         ftp
  236.         ftp.cu.nih.gov           (the name of the ftp site you're logging onto)
  237.         anonymous                (your userid--I know, anonymous logins aren't
  238.                                   trusted for uploads; use your own userid)
  239.         WayneSof@erols.com        (your password)
  240.         cd pub
  241.         cd incoming
  242.  
  243. Now, for each of the files you have, you'd have to enter a command  like  "send
  244. filename", typically followed by a blank line when prompted for  the  recipient
  245. file name.
  246.  
  247. Finally, after you're all done, you'd typically issue a "quit" command.
  248.  
  249. Thinking about it, you can use redirection in DOS to say "FTP <  filename",  as
  250. long as the lines in the text file "filename" contain all of the statements  in
  251. sequence that you need to issue.
  252.  
  253. FORTUNE lets you specify a command  file  which  contains  a  "header"  section
  254. (commands to be sent beforehand), a "main" section (commands  to  be  sent  for
  255. each filename), and a "footer" section (commands to be send  afterward).   Each
  256. section is optional and may consist of up to 20 commands.  In our example, your
  257. command file (we'll call it "FORTUNE.FTP" in this case) might look like this:
  258.  
  259.         /header
  260.         ftp
  261.         ftp.cu.nih.gov
  262.         anonymous
  263.         WayneSof@erols.com
  264.         cd pub
  265.         cd incoming
  266.         /main
  267.         send %A
  268.                                              (blank line)
  269.         /footer
  270.         quit
  271.  
  272. The commands within the "main" section are  repeated  for  each  file  and  can
  273. contain all of the standard FORTUNE features for the command section.
  274.  
  275. If a section is not found, the statements are presumed to be part of the "main"
  276. section (that is, "/main" is presumed at the start of the file).
  277.  
  278.  
  279. FORTUNE.DOC                            7                           Jul 31, 1997
  280.  
  281. The sections can appear in any order.
  282.  
  283. To bring in the command file, specify "DO @filename" instead of  "DO  command".
  284. So, your command line might be:
  285.  
  286.         FORTUNE IN (*.TXT) DO @FORTUNE.FTP
  287.  
  288. This will create a DOIT.BAT file which, in fact, does not contain batch command
  289. statements at all.  If this bothers you, specify a different output  file  name
  290. (using the "/AS filename" parameter) if you want.  Then, to process  this  file
  291. in your FTP command, use standard redirection:
  292.  
  293.         FTP < DOIT.BAT
  294.  
  295. If you  have  /VAR=@  in  effect,  make  it  "DO  @@filename"  instead  of  "DO
  296. @filename".  For example:
  297.  
  298.         FORTUNE IN (*.TXT) /VAR=@ DO @@FORTUNE.FTP
  299.  
  300. Note that using the command file feature disables  processing  of  the  FORTUNE
  301. parameters which are specific to batch files.   These  ignore  parameters  are:
  302. /ECHO, /-ECHO, /ABEND, /-ABEND, /P, and /-P.
  303.  
  304. In addition, you can specify a file that contains the filenames to  process  by
  305. using "/IN @filename" or "IN @filename".  This feature can be very  handy  when
  306. /-CHECK is specified and the file itself contains file names on a remote  host.
  307. For example, this is useful if you're trying to run something like  FORTUNE  on
  308. an ftp host over the Internet to issue a series of "get" commands on that host.
  309.  
  310. One disadvantage of the /-CHECK parameter is that it will  not  parse  out  the
  311. file name at all so only %A-like requests will do any good.
  312.  
  313.  
  314. Specifying parameters:
  315.  
  316. Parameters for this program can be set in the following ways.  The last setting
  317. encountered always wins:
  318.   - Read from an *.INI file (see BRUCEINI.DOC file),
  319.   - Through the use of an environmental variable (SET FORTUNE=whatever), or
  320.   - From the command line (see "Syntax" below)
  321.  
  322. Remember that DOS doesn't allow a command line to exceed 127  characters.   Use
  323. control files whenever necessary.
  324.  
  325.  
  326. FORTUNE.DOC                            8                           Jul 31, 1997
  327.  
  328. Syntax:
  329.  
  330.     FORTUNE { IN (set) | IN filespec | /IN (set) | /IN filespec | filespec }
  331.       [ /AS filename ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  332.       [ /VAR=char ] [ /DELIM=chars ] [ /+n | /-n ] [ /S ] [ /Xfilespec ] ...
  333.       [ /SIZE { GT | GE | LT | LE | EQ | NE } value ]
  334.       [ /DATE { GT | GE | LT | LE | EQ | NE } date ]
  335.       [ /ATTR=attribs ] [ /-ECHO ] [ /-ABEND ] [ /P ]
  336.       [ /RUN ] [ /PROMPT | /-PROMPT ] [ /-CHECK ] [ /-WIPE ]
  337.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ]
  338.       { DO command | /DO command | command }
  339.  
  340. where:
  341.  
  342. "IN (set)" lets you specify the file names  to  be  processed.   Multiple  file
  343. specifications  should  be  separated  by  a  space  or   a   semicolon.    For
  344. compatibility with the FORTUNE-only parameters, "IN" can be preceded by  a  "/"
  345. if desired.  ("IN" and "DO" are supported for compatibility with  the  DOS  FOR
  346. command but all FORTUNE-only parameters must begin with "/".) If only one  file
  347. specification is provided, you can  skip  the  parentheses.   You  can  specify
  348. "%PATH%" (to process all files in your path) or "%PATH%;*.EXE"  (to  process  a
  349. given set of files from your path).  (The "%" character depends on the value of
  350. the /VAR=char paramter.) A file specification is required for FORTUNE.
  351.  
  352. You can specify an input file that contains the file list to process.  This  is
  353. done using "@filename" instead of "set" or "filespec".
  354.  
  355. It's possible to leave off the  "IN"  (or  its  derivatives)  as  well  as  the
  356. parentheses if your file specification(s) include a "\", "*", or "?" character.
  357. For example:
  358.  
  359.         FORTUNE *.BAS *.DOC DO TYPE %A
  360.  
  361. "/AS filename" tells the command the name of the batch file to create with  the
  362. resulting commands.  By default, this file will be called DOIT.BAT and it  will
  363. be created in your default subdirectory.
  364.  
  365. "/OVERWRITE" says to write over any output file that's already there.
  366.  
  367. "/APPEND" says to add the new records at the end  of  any  output  file  that's
  368. already there.  Since FORTUNE uses the same DOS labels every time it  executes,
  369. concatenating FORTUNE-created batch files is not recommended.
  370.  
  371. "/-OVERWRITE" says to abort if the output file exists already.
  372.  
  373. "/OVERASK" says to prompt if the  output  file  exists  already;  this  is  the
  374. default.
  375.  
  376. "/VAR=char" indicates the character to use as the special character  indicator.
  377. This initially defaults to "/VAR=%" under DOS and Windows 3.1 for compatibility
  378. with the existing FOR command.  It initially defaults to  "/VAR=@"  under  4DOS
  379. and Windows 95 due to the way that these operating systems resolve command-line
  380. parameters with "%" in them.  If "/VAR=%" is in effect, remember that you using
  381. a single percent sign for any command entered from the  command  line  but  you
  382. need to double the percent signs (using "%%"  instead  of  "%"  each  time)  if
  383. you're using FORTUNE from within a batch command.  You can avoid this hassle by
  384. picking another character (like /VAR=^) if you'd like.
  385.  
  386.  
  387. FORTUNE.DOC                            9                           Jul 31, 1997
  388.  
  389. "/DELIM=chars" allows you to indicate  delimiters  to  use  between  statements
  390. within the DO command.  Defaults to "/DELIM=$$".  This allows  you  to  process
  391. multiple statements in a single FORTUNE command.  For example:
  392.  
  393.         FORTUNE IN *.BAS DO COPY %A \TEMP $$ TYPE \TEMP\%R.%E
  394.  
  395. Note that the number of characters can be any length (including one character).
  396. Your only consideration is that the characters do not appear together  in  your
  397. command otherwise.  The characters are case insignificant ("/DELIM=newline" and
  398. "/DELIM=NEWLine" are the same thing).
  399.  
  400. "/+n" and "/-n" allow you to specify the increment/decrement value to  be  used
  401. where %0nnnn indicators are used in the command line.  Defaults to "/+1".
  402.  
  403. "/S" processes the children subdirectories as well.  So you could do  something
  404. like any of the following:
  405.  
  406.         FORTUNE IN (\*.BAS) /S COPY %A LPT1:
  407.         FORTUNE IN (\OLD*.TXT) /S DO DELETE %A
  408.  
  409. The next example is a little bizarre.  Let's say  you're  using  an  anti-virus
  410. protection program that maintains a read-only file in  each  subdirectory  with
  411. all of the virus signatures for the files in that subdirectory.  You decide you
  412. no longer want to use that program again but you have a zillion of these  files
  413. and they're all read-only.  The following example would search  them  all  out,
  414. reset them to not be read-only, and then delete them.
  415.  
  416.         FORTUNE IN (\VIRCK.SIG) /S DO ATTRIB %A -R $$ DEL %a
  417.  
  418. "/Xfilespec" says to exclude certain filespecs from being considered.  You  can
  419. specify up to 10 exclusion parameters but  each  must  begin  with  "/X".   For
  420. example, you could process all *.BAS files except D*.BAS and E*.BAS files with:
  421.  
  422.         FORTUNE IN (*.BAS) /XD*.BAS /XE*.BAS DO TYPE %A
  423.  
  424. "/SIZE xx value" says you want to limit the list of individual files  to  those
  425. which meet a certain size requirement.   Due  to  DOS's  redirection  commands,
  426. relations like ">" and "<" don't  work  so  you  have  to  use  the  two-letter
  427. abbreviations:
  428.  
  429.         GT      greater than                    >
  430.         GE      greater than or equal to        >=
  431.         LT      less than                       <
  432.         LE      less than or equal to           <=
  433.         EQ      equal to                        =
  434.         NE      not equal to                    <>
  435.  
  436. Having said that, the only two you're likely to use are GT and GE.  The "value"
  437. is the size value you want tested for.  So "/SPACE GT 1000000" would  find  all
  438. individual files with a filesize greater than one million bytes.
  439.  
  440. "/DATE xx date" says to show only those files created before or after  a  given
  441. date.  As before, you have to use GT, GE, LT, LE, EQ, and NE for the relational
  442. operator.  "/DATE GE 10/01/91" would show only those files created on or  after
  443. October 1, 1991.  The format for the date is determined by your system settings
  444. (it might be "/DATE GE 10.01.91" in France).
  445.  
  446.  
  447. FORTUNE.DOC                            10                          Jul 31, 1997
  448.  
  449. "/ATTR=attribs" allows you to specify a combination of attributes that you want
  450. considered.  You can specify any combination of R (read-only),  H  (hidden),  S
  451. (system), or A (archive bit).  Precede any character(s)  with  "-"  to  exclude
  452. instead of include.  Unlike with  the  DOS  DIR  command,  the  inclusions  and
  453. exclusions are subject to "OR" conditions; /ATTR=HS will retrieve any file that
  454. is either hidden or a system file or both.   You  can  specify  "/ATTR=ALL"  to
  455. specify that all files are to be processed.  Initially  defaults  to  /ATTR=ALL
  456. (don't exclude any files from consideration).
  457.  
  458. "/ECHO" says to turn ECHO ON in the batch file.  This  will  show  the  command
  459. being executed before it executes.  This is initially the default.
  460.  
  461. "/-ECHO" says to turn ECHO OFF in the batch file.
  462.  
  463. "/ABEND" (abnormal end) says to use standard DOS errorlevel trapping to see  if
  464. there was an error in running the command.  If any non-0  errorlevel  condition
  465. is encountered (for example, an error has occurred), the batch file will branch
  466. out, skipping the rest of the statements in the batch file and aborting.   Note
  467. that not all commands return  decent  errorlevel  codes.   COPY,  for  example,
  468. doesn't set an errorlevel to  indicate  that  the  file  could  not  be  found.
  469. "/ABEND" is the initially the default.
  470.  
  471. "/-ABEND" says to skip errorlevel testing.
  472.  
  473. "/P" (or "/PAUSE") says to add a PAUSE statement after  each  statement  that's
  474. executed.  If you don't like what you see, you can press Ctrl-Break and get out
  475. of the batch file.
  476.  
  477. "/-P" (or "/-PAUSE")  skips  the  PAUSE  statements.   This  is  initially  the
  478. default.
  479.  
  480. "/RUN" says to try to run the commands interactively instead of writing out the
  481. batch file.  This only works for commands that don't  take  much  memory  (like
  482. RENAME and COPY commands).  The default is initially "/-RUN".
  483.  
  484. "/-RUN" says to write the commands out to the standard batch file.  This is the
  485. initially the default.
  486.  
  487. "/PROMPT" says to prompt you before either writing (if  /-RUN  being  used)  or
  488. executing (if /RUN being used).  You are given the choice of  "Yes",  "No",  or
  489. "Abort" if prompting is turned  on.   The  default  is  "/PROMPT"  if  /RUN  is
  490. selected, otherwise "/-PROMPT".
  491.  
  492. "/-PROMPT" says to skip the prompts for each command.  The default is "/PROMPT"
  493. if /RUN is selected, otherwise "/-PROMPT".
  494.  
  495. "/CHECK" says that when an "/IN @filename" is  used,  verify  each  data  set's
  496. existence.  This is initially the default.
  497.  
  498. "/-CHECK" skips the data set checking.  This  is  useful  when  you're  issuing
  499. something like a series of GET commands using FTP; the data sets  in  the  "/IN
  500. @filename" may be on a remote host which can't be verified when FORTUNE is run.
  501. Initially defaults to "/CHECK".
  502.  
  503.  
  504. FORTUNE.DOC                            11                          Jul 31, 1997
  505.  
  506. "/WIPE" says to kill the batch file (for example,  DOIT.BAT)  after  successful
  507. completion.  This produces an annoying error message ("Batch file missing") but
  508. may be preferable to  keeping  the  batch  file  around  afterward.   Initially
  509. defaults to "/WIPE".
  510.  
  511. "/-WIPE" says to keep the batch file around after completion.  This avoids  the
  512. ugly error message  but  leaves  the  file  in  your  subdirectory.   Initially
  513. defaults to "/WIPE".
  514.  
  515. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  516. defaults to "/COLOR".
  517.  
  518. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  519. initially the default.
  520.  
  521. "/Iinitfile" says to read an initialization file with the file name "initfile".
  522. The file specification *must* contain a period.  Initfiles are described in the
  523. BRUCEINI.DOC file.  Initially defaults to "/IFORTUNE.INI".
  524.  
  525. "/-I" (or "/INULL") says to skip loading the initialization file.
  526.  
  527. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  528. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  529. more information.  This is initially the default.
  530.  
  531. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  532. Initially defaults to "/ENV".
  533.  
  534. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  535.  
  536. "DO command" (or "/DO command" or just "command") specifies the  command(s)  to
  537. be executed.  For compatibility with the FORTUNE-only parameters, "DO"  can  be
  538. preceded by a "/" if desired.  ("IN" and "DO" are supported  for  compatibility
  539. with the DOS FOR command but all FORTUNE-only parameters must begin with  "/".)
  540. A command is  required.   Multiple  commands  can  be  specified  if  they  are
  541. separated using the characters specified in the  /DELIM=chars  parameter.   You
  542. can also use a command file by using /DO @filename; see the previous discussion
  543. on "Using a command file for special cases".
  544.  
  545. In  most  cases,  the  use  of  the  "DO"  (or  "/DO")  parameter  is  actually
  546. unnecessary.  The routine typically treats all of the following as identical:
  547.  
  548.         FORTUNE IN (*.BAS *.DOC) DO TYPE %A
  549.         FORTUNE IN (*.BAS *.DOC) TYPE %A
  550.         FORTUNE *.BAS *.DOC TYPE %A
  551.  
  552. However, using the "DO" (or "/DO") parameter  adds  an  extra  level  of  error
  553. checking and its use is encouraged.
  554.  
  555.  
  556.  
  557. FORTUNE.DOC                            12                          Jul 31, 1997
  558.  
  559. Return codes:
  560.  
  561. FORTUNE returns the following ERRORLEVEL codes:
  562.         0 = no problems, files found and batch file created
  563.         1 = no problems, no files met specifications
  564.       250 = operation aborted by pressing Escape
  565.       255 = syntax problems, file not found, or /? requested
  566.  
  567.  
  568. Author:
  569.  
  570. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  571. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  572. program, no changes are made to the program or documentation,  and  it  is  not
  573. bundled with commercial programs or charged for separately.  People who need to
  574. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  575. Software" at the following address.
  576.  
  577. Additional information about this and other  Wayne  Software  programs  can  be
  578. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  579. The recent change history for this and the other programs is  provided  in  the
  580. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  581. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  582. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  583. naming the ZIP file (FORTNymm.ZIP) that this program was included in.
  584.  
  585. Comments and suggestions can also be sent to:
  586.  
  587.                 Bruce Guthrie
  588.                 Wayne Software
  589.                 113 Sheffield St.
  590.                 Silver Spring, MD 20910
  591.  
  592.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  593.                 http://www.geocities.com/SiliconValley/Lakes/2414
  594.  
  595. Please provide an Internet e-mail address on all correspondence.
  596.  
  597. 
  598.